home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / X11 / xcalendar.z / xcalendar
Text File  |  1998-10-30  |  23KB  |  529 lines
  1.  
  2.  
  3.  
  4.      xxxxccccaaaalllleeeennnnddddaaaarrrr((((1111))))       XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((6666 JJJJuuuunnnneeee 1111999999994444))))        xxxxccccaaaalllleeeennnnddddaaaarrrr((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           xcalendar - calendar with a notebook for X11
  10.  
  11.      SSSSYYYYNNNNTTTTAAAAXXXX
  12.           xxxxccccaaaalllleeeennnnddddaaaarrrr [month [year]]]]]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.           _x_c_a_l_e_n_d_a_r is a simple interactive calendar program with a
  16.           notebook capability. It is built on the X Toolkit and the
  17.           Athena or Motif Widgets (compile time option).
  18.  
  19.           If month and year are not provided on the command line they
  20.           are assumed to be current.
  21.  
  22.      IIIINNNNTTTTEEEERRRRAAAACCCCTTTTIIIIOOOONNNNSSSS
  23.           Clicking the left mouse button on a day will start a text
  24.           editor.  You can edit and save a text.  This text will be
  25.           associated with the day. You can later on read and edit this
  26.           text when you open the editor for the same day. The text is
  27.           saved in a file in the directory specified by the
  28.           calendarDir resource (default ~/Calendar). The editor lets
  29.           you also clear an entry associated with a particular day.
  30.           You can also scroll through days while in the editor by
  31.           clicking on the arrows on either side of the date label.  If
  32.           an already open day is scrolled to, an appropriate message
  33.           is displayed and the editor is brought upin read only mode.
  34.  
  35.           It is also possible to scroll through months in the main
  36.           window by clicking on the arrows on either side of the
  37.           current date label.
  38.  
  39.           You can highlight all entries in a month by invoking the
  40.           function ShowEntries. By default this function is called
  41.           when the left mouse button is pressed in the title window
  42.           (where month and a year are displayed).  Pressing again the
  43.           same button will unhighlight the entries.
  44.  
  45.           "Holidays" are shown in a text widget near the bottom of the
  46.           day editor.  Holidays are read from a holiday file (see
  47.           holidayFile below).  The format of the file is mm/dd/yyyy
  48.           holidaytext where the date and text are separated by a tab.
  49.           Currently there is no wildcarding done.
  50.  
  51.      MMMMIIIISSSSSSSSIIIINNNNGGGG FFFFEEEEAAAATTTTUUUURRRREEEESSSS
  52.           One can imagine many useful features. For example automatic
  53.           parsing of the current day entry in search for appointments
  54.           to trigger alarms (reminders) at the approriate time.
  55.           Actually, there is a perl script called _x_c_a_l_e_n_d_a_r+ that will
  56.           do this sort of thing.  Maybe one day _x_c_a_l_e_n_d_a_r will do it
  57.           internally.
  58.  
  59.      RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
  60.  
  61.  
  62.  
  63.      PPPPaaaaggggeeee 1111                                          ((((pppprrrriiiinnnntttteeeedddd 4444////33330000////99998888))))
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      xxxxccccaaaalllleeeennnnddddaaaarrrr((((1111))))       XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((6666 JJJJuuuunnnneeee 1111999999994444))))        xxxxccccaaaalllleeeennnnddddaaaarrrr((((1111))))
  71.  
  72.  
  73.  
  74.           The resource data base lets you alter the visual appearance
  75.           of the program. You can change fonts, border widths, labels,
  76.           and other resources used by widgets. One use of this
  77.           facility is to change names of week days and months.
  78.  
  79.           Here are the names of widgets you can use to set various
  80.           resources:
  81.  
  82.                XCalendar    - class of the application
  83.                xcalendar    - top level pane
  84.                controls     - control panel
  85.                quitButton   - quit button
  86.                helpButton   - help button
  87.                date         - date label
  88.                calendar     - calendar pane
  89.                daynumbers   - day numbers frame
  90.                1-49         - day number buttons
  91.                daynames     - day names frame
  92.                MON,TUE,WED,THU,FRI,SAT,SUN - day name buttons
  93.                helpWindow   - help window
  94.                bcontrols    - month buttons frame
  95.                prev         - previous month button
  96.                succ         - succeeding month button
  97.                cdate        - current date widget
  98.                dayEditor    - editor popup
  99.                editorFrame  - editor frame
  100.                editorTitle  - editor title
  101.                editor       - editor
  102.                holiday      - holiday text
  103.                daybuttons   - day buttons frame
  104.                prevday      - previous day button
  105.                succday      - succeeding day button
  106.                editorControls - control panel
  107.                doneButton   - done button
  108.                saveButton   - save button
  109.                clearEntry   - clear entry button
  110.  
  111.  
  112.           Application specific resources:
  113.  
  114.                reverseVideoMark  - if True the entries are highlighted in reverse
  115.                                    video;  default True for monochrome displays
  116.                                    and False for color displays;
  117.  
  118.                setMarkBackground - if True and reverseVideoMark is False the
  119.                                    entries are highlighted by setting
  120.                                    background to markBackground ;
  121.  
  122.                markBackground    - background color for highlighting entries;
  123.  
  124.                setMarkForeground - analogous to setMarkBackground;
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      xxxxccccaaaalllleeeennnnddddaaaarrrr((((1111))))       XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((6666 JJJJuuuunnnneeee 1111999999994444))))        xxxxccccaaaalllleeeennnnddddaaaarrrr((((1111))))
  137.  
  138.  
  139.  
  140.                markForeground    - foreground color for highlighting entries;
  141.  
  142.                _s_e_t_M_a_r_k_B_a_c_k_g_r_o_u_n_d and _s_e_t_M_a_r_k_F_o_r_e_g_r_o_u_n_d can take any
  143.                combination of values.
  144.  
  145.                january,february,..,december - these resources can be used for
  146.                                    changing names of months in the month label
  147.                                    (date) and for filename determination under
  148.                                    oldStyle (see below);
  149.  
  150.                firstDay          - an integer between 1-7,  indicating the day to
  151.                                    start a week with, default:  7 (Sunday);
  152.  
  153.                markOnStartup     - if True mark the entries upon startup,
  154.                                    default: False;
  155.  
  156.                helpFile          - full pathname of the xcalendar.hlp file,
  157.                                    default: /usr/lib/X11/xcalendar/xcalendar.hlp;
  158.  
  159.                textBufferSize    - maximum size of the text buffer in the day editor,
  160.                                    default: 2048;
  161.  
  162.                calendarDir       - path name of directory to use for storing calendar
  163.                                    files instead of keeping them in $HOME/Calendar;
  164.  
  165.                holidayFile       - path name of file to use for determining holiday,
  166.                                    default: /usr/lib/X11/xcalendar/xcalendar.hol;
  167.  
  168.                oldStyle          - uses version 3.0 and prior file naming convention,
  169.                                    (xcDAYmonYEAR), where DAY and YEAR are numeric and
  170.                                    mon is the first three letters of the month,
  171.                                    instead of the "new style" (xcyyyymmdd),
  172.                                    default: True;
  173.  
  174.                markCurrent       - if True mark the current day (if visible; useful
  175.                                    on color displays only), default: False;
  176.  
  177.                updateCurrent     - number of seconds between attempts to update the
  178.                                    marking of the current day, default: 60;
  179.  
  180.                currentForeground - foreground color for current day highlight;
  181.  
  182.                markHoliday       - if True mark holidays (if visible; useful on
  183.                                    color displays only), default: False;
  184.  
  185.                holidayForeground - foreground color for holiday highlight;
  186.  
  187.                monthnames        - string of '/' separated month names used for
  188.                                    formatting the date in cdate;
  189.  
  190.                monthnms          - string of '/' separated month abbreviations used
  191.                                    for formatting the date in cdate;
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      xxxxccccaaaalllleeeennnnddddaaaarrrr((((1111))))       XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((6666 JJJJuuuunnnneeee 1111999999994444))))        xxxxccccaaaalllleeeennnnddddaaaarrrr((((1111))))
  203.  
  204.  
  205.  
  206.                daynames          - string of '/' separated day names used for
  207.                                    formatting the date in cdate;
  208.  
  209.                daynms            - string of '/' separated day abbreviations used
  210.                                    for formatting the date in cdate;
  211.  
  212.                date              - format string for date in cdate.  The formatting
  213.                                    characters that are understood are:
  214.  
  215.                         %W      Full weekday name
  216.                         %w      Three-char weekday name
  217.                         %M      Full month name
  218.                         %m      Three-char abbreviation for that month
  219.                         %d      The date (numerical day number of the month)
  220.                         %Y      Full year (4 digits)
  221.                         %y      2-digit year number
  222.  
  223.                                    default: "%W, %M %d";
  224.  
  225.  
  226.      DDDDEEEEFFFFAAAAUUUULLLLTTTT RRRREEEESSSSOOOOUUUURRRRCCCCEEEE DDDDAAAATTTTAAAA BBBBAAAASSSSEEEE::::
  227.                !
  228.                *showGrip:          False
  229.                *calendar*internalBorderWidth: 0
  230.                *input:        True
  231.                *resize: False
  232.                *resizable: True
  233.                *title: XCalendar v.4.0
  234.                *dayEditor.title: Day Editor
  235.                *helpWindow.title: XCalendar Help
  236.                *Font: 8x13
  237.                *FontList: 8x13
  238.  
  239.                *helpFile:     /p/X11R6/lib/X11/xcalendar/xcalendar.hlp
  240.                *holidayFile:  /p/X11R6/lib/X11/xcalendar/xcalendar.hol
  241.  
  242.                *firstDay:          7
  243.  
  244.                ! bitmaps
  245.  
  246.                *prev*bitmap: /p/X11R6/lib/X11/xcalendar/larrow.xbm
  247.                *succ*bitmap: /p/X11R6/lib/X11/xcalendar/rarrow.xbm
  248.                *prevday*bitmap: /p/X11R6/lib/X11/xcalendar/larrow.xbm
  249.                *succday*bitmap: /p/X11R6/lib/X11/xcalendar/rarrow.xbm
  250.                *helpButton*bitmap: /p/X11R6/lib/X11/xcalendar/qmark.xbm
  251.                *quitButton*bitmap: /p/X11R6/lib/X11/xcalendar/quit.xbm
  252.                *prev*labelType: XmPIXMAP
  253.                *prev*labelPixmap: /usr/local/X11R5/lib/X11/xcalendar/larrow.xbm
  254.                *succ*labelType: XmPIXMAP
  255.                *succ*labelPixmap: /usr/local/X11R5/lib/X11/xcalendar/rarrow.xbm
  256.                *prevday*labelType: XmPIXMAP
  257.                *prevday*labelPixmap: /usr/local/X11R5/lib/X11/xcalendar/larrow.xbm
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 4/30/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      xxxxccccaaaalllleeeennnnddddaaaarrrr((((1111))))       XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((6666 JJJJuuuunnnneeee 1111999999994444))))        xxxxccccaaaalllleeeennnnddddaaaarrrr((((1111))))
  269.  
  270.  
  271.  
  272.                *succday*labelType: XmPIXMAP
  273.                *succday*labelPixmap: /usr/local/X11R5/lib/X11/xcalendar/rarrow.xbm
  274.                *quitButton*labelType: XmPIXMAP
  275.                *quitButton*labelPixmap: /usr/local/X11R5/lib/X11/xcalendar/quit.xbm
  276.                *helpButton*labelType: XmPIXMAP
  277.                *helpButton*labelPixmap: /usr/local/X11R5/lib/X11/xcalendar/qmark.xbm
  278.  
  279.  
  280.                ! colors
  281.                ! Note: These may cause problems using the -rv option on monochrome displays
  282.  
  283.                *Background: lightgray
  284.                *markBackground: gray
  285.                *daynames*Background: lightgray
  286.                *daynames.SUN*Foreground: Red
  287.                *daynames.SAT*Foreground: Black
  288.                *daynumbers*Foreground:   Black
  289.                *daynumbers.1*Foreground: Red
  290.                *daynumbers.8*Foreground: Red
  291.                *daynumbers.15*Foreground: Red
  292.                *daynumbers.22*Foreground: Red
  293.                *daynumbers.29*Foreground: Red
  294.                *daynumbers.36*Foreground: Red
  295.                *helpButton*Background: slategray
  296.                *helpButton*Foreground: White
  297.                *quitButton*Background: slategray
  298.                *quitButton*Foreground: White
  299.                *editorTitle*Background: lightgray
  300.                *editorTitle*Foreground: Black
  301.                *editorControls*Background: lightgray
  302.                *editorControls*Command.Background: slategray
  303.                *editorControls*Command.Foreground: White
  304.                *editorControls*XmPushButton.Background: slategray
  305.                *editorControls*XmPushButton.Foreground: White
  306.  
  307.                *setMarkBackground: True
  308.                *markOnStartup: True
  309.                *markCurrent: True
  310.                *currentForeground: Blue
  311.                *markHoliday: True
  312.                *holidayForeground: Red
  313.                *holiday*fontList: 6x13
  314.  
  315.                *BorderWidth:       2
  316.                *calendar.borderWidth:   1
  317.                *borderWidth: 0
  318.                *date*borderWidth: 0
  319.                *date*vertDistance: 5
  320.  
  321.                *date*font:                   8x13bold
  322.                *daynames*font:               8x13bold
  323.                *dayEditor*editorTitle*font:       8x13bold
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 4/30/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      xxxxccccaaaalllleeeennnnddddaaaarrrr((((1111))))       XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((6666 JJJJuuuunnnneeee 1111999999994444))))        xxxxccccaaaalllleeeennnnddddaaaarrrr((((1111))))
  335.  
  336.  
  337.  
  338.                *helpWindow*editorTitle*font:           8x13bold
  339.                *date*fontList:               8x13bold
  340.                *daynames*fontList:           8x13bold
  341.                *dayEditor*editorTitle*fontList:   8x13bold
  342.                *helpWindow*editorTitle*fontList:  8x13bold
  343.  
  344.                *helpButton*vertDistance: 12
  345.                *quitButton*vertDistance: 12
  346.                *editorTitle*vertDistance: 5
  347.  
  348.                *editorControls*doneButton*label: Done
  349.                *editorControls*saveButton*label: Save
  350.                *editorControls*clearEntry*label: Clear Entry
  351.                *doneButton*labelString: Done
  352.                *saveButton*labelString: Save
  353.                *clearEntry*labelString: Clear Entry
  354.  
  355.                *helpWindow*editorTitle*label: Help
  356.                *helpWindow*editorTitle*labelString: Help
  357.                *helpWindow*rows: 15
  358.                *helpWindow*columns: 80
  359.                *rows:7
  360.                *columns: 30
  361.  
  362.                *dayEditor*Paned*editor.width: 300
  363.                *dayEditor*Paned*editor.height: 150
  364.                *helpWindow*Paned*editor.width: 600
  365.                *helpWindow*Paned*editor.height: 350
  366.  
  367.                *bcontrols*borderWidth: 0
  368.                *prev*highlightThickness: 0
  369.                *succ*highlightThickness: 0
  370.  
  371.                *prevday*highlightThickness: 0
  372.                *succday*highlightThickness: 0
  373.                *daybuttons*borderWidth: 0
  374.  
  375.                *Scrollbar.borderWidth: 1
  376.                *Text*scrollVertical: whenNeeded
  377.                *scrollHorizontal: False
  378.                *helpWindow*scrollHorizontal: True
  379.                *holiday*cursorPositionVisible: False
  380.                *holiday*displayCaret: False
  381.                *helpWindow*cursorPositionVisible: False
  382.                *helpWindow*displayCaret: False
  383.  
  384.                !! Keyboard accelerators for Athena version
  385.  
  386.                *Box*doneButton*accelerators: #override \n\
  387.                     Meta<Key>q: set() notify() reset() \n
  388.                *Box*saveButton*accelerators: #override \n\
  389.                     Meta<Key>s: set() notify() reset() \n
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 4/30/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      xxxxccccaaaalllleeeennnnddddaaaarrrr((((1111))))       XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((6666 JJJJuuuunnnneeee 1111999999994444))))        xxxxccccaaaalllleeeennnnddddaaaarrrr((((1111))))
  401.  
  402.  
  403.  
  404.                *Box*clearEntry*accelerators: #override \n\
  405.                     Meta<Key>c: set() notify() reset() \n
  406.  
  407.                *Form*prevday*accelerators: #override \n\
  408.                     Meta<Key>p: set() notify() reset() \n
  409.                *Form*succday*accelerators: #override \n\
  410.                     Meta<Key>n: set() notify() reset() \n
  411.  
  412.                *Form*prev*accelerators: #override \n\
  413.                     <Key>p: set() notify() reset() \n
  414.                *Form*succ*accelerators: #override \n\
  415.                     <Key>n: set() notify() reset() \n
  416.                *Form*quitButton*accelerators: #override \n\
  417.                     <Key>q: set() notify() \n
  418.  
  419.  
  420.                ! Motif text translations to make it work like emacs
  421.  
  422.                *XmText.translations: #override\n\
  423.                         Ctrl <Key>b:            backward-character()\n\
  424.                         Alt <Key>b:             backward-word()\n\
  425.                         Meta <Key>b:            backward-word()\n\
  426.                         Shift Alt <Key>b:       backward-word(extend)\n\
  427.                         Shift Meta <Key>b:      backward-word(extend)\n\
  428.                         Alt <Key>[:             backward-paragraph()\n\
  429.                         Meta <Key>[:            backward-paragraph()\n\
  430.                         Shift Alt <Key>[:       backward-paragraph(extend)\n\
  431.                         Shift Meta <Key>[:      backward-paragraph(extend)\n\
  432.                         Alt <Key><:             beginning-of-file()\n\
  433.                         Meta <Key><:            beginning-of-file()\n\
  434.                         Ctrl <Key>a:            beginning-of-line()\n\
  435.                         Shift Ctrl <Key>a:      beginning-of-line(extend)\n\
  436.                         Ctrl <Key>osfInsert:    copy-clipboard()\n\
  437.                         Shift <Key>osfDelete:   cut-clipboard()\n\
  438.                         Shift <Key>osfInsert:   paste-clipboard()\n\
  439.                         Alt <Key>>:             end-of-file()\n\
  440.                         Meta <Key>>:            end-of-file()\n\
  441.                         Ctrl <Key>e:            end-of-line()\n\
  442.                         Shift Ctrl <Key>e:      end-of-line(extend)\n\
  443.                         Ctrl <Key>f:            forward-character()\n\
  444.                         Alt <Key>]:             forward-paragraph()\n\
  445.                         Meta <Key>]:            forward-paragraph()\n\
  446.                         Shift Alt <Key>]:       forward-paragraph(extend)\n\
  447.                         Shift Meta <Key>]:      forward-paragraph(extend)\n\
  448.                         Ctrl Alt <Key>f:        forward-word()\n\
  449.                         Ctrl Meta <Key>f:       forward-word()\n\
  450.                         Ctrl <Key>d:            kill-next-character()\n\
  451.                         Alt <Key>BackSpace:     kill-previous-word()\n\
  452.                         Meta <Key>BackSpace:    kill-previous-word()\n\
  453.                         Ctrl <Key>w:            key-select() kill-selection()\n\
  454.                         Ctrl <Key>y:            unkill()\n\
  455.                         Ctrl <Key>k:            kill-to-end-of-line()\n\
  456.  
  457.  
  458.  
  459.      Page 7                                          (printed 4/30/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      xxxxccccaaaalllleeeennnnddddaaaarrrr((((1111))))       XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((6666 JJJJuuuunnnneeee 1111999999994444))))        xxxxccccaaaalllleeeennnnddddaaaarrrr((((1111))))
  467.  
  468.  
  469.  
  470.                         Alt <Key>Delete:        kill-to-start-of-line()\n\
  471.                         Meta <Key>Delete:       kill-to-start-of-line()\n\
  472.                         Ctrl <Key>o:            newline-and-backup()\n\
  473.                         Ctrl <Key>j:            newline-and-indent()\n\
  474.                         Ctrl <Key>n:            next-line()\n\
  475.                         Ctrl <Key>osfLeft:      page-left()\n\
  476.                         Ctrl <Key>osfRight:     page-right()\n\
  477.                         Ctrl <Key>p:            previous-line()\n\
  478.                         Ctrl <Key>g:            process-cancel()\n\
  479.                         Ctrl <Key>l:            redraw-display()\n\
  480.                         Ctrl <Key>osfDown:      next-page()\n\
  481.                         Ctrl <Key>osfUp:        previous-page()\n\
  482.                         Ctrl <Key>space:        set-anchor()\n
  483.  
  484.  
  485.      FFFFIIIILLLLEEEESSSS
  486.           $HOME/Calendar/*, /usr/lib/X11/xcalendar/xcalendar.hlp,
  487.           /usr/lib/X11/xcalendar/xcalendar.hol
  488.  
  489.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  490.           xrdb(1), xcalendar+(1)
  491.  
  492.      BBBBUUUUGGGGSSSS
  493.           I'm sure there are some.  If you find any, let me
  494.           (bingle@cs.purdue.edu) know.
  495.  
  496.      AAAAUUUUTTTTHHHHOOOORRRRSSSS
  497.           Copyright 1988 by Massachusetts Institute of Technology
  498.           Roman J. Budzianowski, MIT Project Athena
  499.  
  500.           Copyright 1990-1994 by Purdue University
  501.           Richard Bingle, Department of Computer Sciences
  502.  
  503.           Enhancements/Suggestions by:
  504.           Beth Chaney
  505.           Purdue University, Department of Computer Sciences
  506.  
  507.           Mike Urban
  508.           Jet Propulsion Labs, NASA
  509.  
  510.           Joel Neisen
  511.           Minnesota Supercomputer Center
  512.  
  513.           Hiroshi Kuribayashi
  514.           Omron Corp.
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.      Page 8                                          (printed 4/30/98)
  526.  
  527.  
  528.  
  529.